Rejestr koordynatorów
Rejestr koordynatorów obejmuje dane pracowników medycznych pełniących rolę koordynatora w ramach KSK.
Rejestracji koordynatora może dokonać dowolny pracownik w podmiocie uczestniczącym w KSK.
Rejestr umożliwia:
Wskazanie koordynatora w ramach karty e-KOK odbywa się poprzez umieszczenie referencji w zasobie FHIR Encounter z danymi świadczenia (PLEKOKEncounter) w atrybucie Encounter.participant:coordinator
Rejestracja danych koordynatora
Rejestracja danych koordynatora polega na zarejestrowaniu zasobu FHIR z danymi zawierającymi role koordynatora (PLEKOKCustodian) oraz (opcjonalnie) zasobu FHIR z danymi identyfikacyjnymi osoby będącej koordynatorem (PLEKOKPractitioner).
Koordynator rejestrowany jest na poziomie placówki. W przypadku, gdy dana osoba pełni rolę koordynatora w kilku placówkach, dla każdej z nich należy zarejestrować osobny zasób FHIR z danymi zawierającymi role koordynatora w danej placówce.
Przed zarejestrowaniem roli koordynatora w danej placówce należy:
- zarejestrować dane identyfikacyjne osoby będącej koordynatorem (dane identyfikujące osobę rejestrujemy tylko jeden raz),
- wyszukać dane placówki medycznej w kontekście której pracuje koordynator.
Rejestracja danych identyfikujących osobę będącą koordynatorem
Rejestracja danych identyfikujących osobę będącą koordynatorem polega na zarejestrowaniu zasobu FHIR z danymi identyfikującymi.
Warunki wejściowe:
- Pobrany token dostępowy
Scenariusz:
- Rejestracja danych identyfikacyjnych osoby będącej koordynatorem, w oparciu o zasób FHIR Practitioner, w zakresie zdefiniowanym w profilu PLEKOKPractitioner
Rejestracja danych roli koordynatora
Rejestracja danych roli koordynatora polega na zarejestrowaniu zasobu FHIR z rolę koordynatora.
Warunki wejściowe:
- Pobrany token dostępowy
Scenariusz :
- Rejestracja danych zawierających role koordynatora, w oparciu o zasób FHIR PractitionerRole, w zakresie zdefiniowanym w profilu PLEKOKCustodian, w szczególności :
Aktualizacja danych koordynatora
Aktualizacja danych roli koordynatora
Aktualizacja danych roli koordynatora polega na aktualizacji zasobu FHIR z danymi zawierającymi role koordynatora.
Warunki wejściowe:
- Pobrany token dostępowy
Scenariusz:
- Aktualizacja danych zawierających role koordynatora, w oparciu o zasób FHIR PractitionerRole, w zakresie zdefiniowanym w profilu PLEKOKCustodian
Dezaktywacja roli koordynatora
Dezaktywacja roli koordynatora polega na aktualizacji statusu aktywności roli koordynatora w zasobie FHIR z danymi zawierającymi role koordynatora.
Warunki wejściowe:
- Pobrany token dostępowy
Scenariusz:
- Aktualizacja danych zawierających role koordynatora, w oparciu o zasób FHIR PractitionerRole, w zakresie zdefiniowanym w profilu PLEKOKCustodian, w szczególności:
- status aktywności roli koordynatora zawierający wartość zgodną z nieaktywną rolą koordynatora:
Aktualizacja danych identyfikujących osobę będącą koordynatorem
Aktualizacja danych identyfikujących osobę będącą koordynatorem polega na aktualizacji zasobu FHIR z danymi identyfikującymi.
Warunki wejściowe:
- Pobrany token dostępowy
Scenariusz:
- Aktualizacja danych identyfikujacych osobę będącą koordynatorem, w oparciu o zasób FHIR Practitioner, w zakresie zdefiniowanym w profilu PLEKOKPractitioner
Odczyt danych koordynatora
Odczyt danych zawierających role koordynatora
System umożliwia odczyt danych zawierających role koordynatora w oparciu o identyfikator logiczny zasobu FHIR.
Warunki wejściowe:
- Pobrany token dostępowy
Scenariusz:
- Odczyt danych zawierających role koordynatora, w oparciu o zasób FHIR PractitionerRole, w zakresie zdefiniowanym w profilu PLEKOKCustodian
Odczyt danych identyfikujących osobę będącą koordynatorem
System umożliwia odczyt zasobu FHIR z danymi identyfikującymi osobę będącą koordynatorem w oparciu o identyfikator logiczny zasobu.
Warunki wejściowe:
- Pobrany token dostępowy
Scenariusz:
- Odczyt danych identyfikujacych osobę będącą koordynatorem, w oparciu o zasób FHIR Practitioner, w zakresie zdefiniowanym w profilu PLEKOKPractitioner
Ze względu na ochronę danych osobowych numer PESEL osoby będącej koordynatorem nie jest zwracamy w wyniku odczytu.
Wyszukanie danych koordynatora
Wyszukanie danych zawierających role koordynatora
Wyszukanie danych zawierających role koordynatora polega na wyszukaniu zasobu PractitionerRole, w oparciu o zadane kryteria w tym dane identyfikujące osoby będącej koordynatorem znajdujące się w zasobie Practitioner.
Warunki wejściowe:
- Pobrany token dostępowy
Scenariusz:
- Wyszukanie danych zawierających role koordynatora, w oparciu o zasób FHIR PractitionerRole, w zakresie zdefiniowanym w profilu PLEKOKCustodian.
Dostępne kryteria wyszukiwania :
- code (PractitionerRole.code) - Rola pracownika medycznego w ramach KSK
- organization-display (PractitionerRole.organization.display) - Nazwa podmiotu leczniczego
- organization-identifier (PractitionerRole.organization.identifier) - Identyfikator podmiotu leczniczego
- practitioner:Practitioner.identifier (Practitioner.identifier) - Identyfikator osoby,
- practitioner:Practitioner.family (Practitioner.name.family) - Nazwisko osoby,
- practitioner:Practitioner.given (Practitioner.name.given) - Imię osoby,
- location:Location.identifier (Location.identifier) - Identyfikator placówki medycznej w kontekście której pracuje osoba,
- location:Location.name (Location.name) - Nazwa placówki medycznej w kontekście której pracuje osoba,
- location:Location.address-city (Location.address.city) - Miejscowość, w której znajduje się placówka medyczna
oraz pozostałe parametry wyszukania zgodnie ze specyfikacją FHIR dla zasobów PractitionerRole
Przykład żądania wyszukania danych zawierających role koordynatora podmiotu z podaniem identyfikatora podmiotu:
- GET https://{adres serwera FHIR}/ekok/fhir/PractitionerRole/?organization-identifier={PractitionerRole.organization.identifier.system}|{PractitionerRole.organization.identifier.value}&role=organization_coordinator
Przykład żądania wyszukania danych zawierających role koordynatora pacjenta z podaniem identyfikatora podmiotu:
- GET https://{adres serwera FHIR}/ekok/fhir/PractitionerRole/?organization-identifier={PractitionerRole.organization.identifier.system}|{PractitionerRole.organization.identifier.value}&role=patient_coordinator
Przykład żądania wyszukania danych zawierających role koordynatora podmiotu z podaniem identyfikatora osoby będącej koordynatorem - PESEL/NPWZ:
- GET https://{adres serwera FHIR}/ekok/fhir/PractitionerRole?practitioner:Practitioner.identifier={Practitioner.identifier.system}|{Practitioner.identifier.value}&role=organization_coordinator
Przykład żądania wyszukania danych zawierających role koordynatora podmiotu z podaniem nazwiska koordynatora:
- GET https://{adres serwera FHIR}/ekok/fhir/PractitionerRole?practitioner:Practitioner.family={Practitioner.name.family}&role=organization_coordinator
Przykład żądania wyszukania danych zawierających role koordynatora podmiotu z podaniem identyfikatora placówki w której pracuje:
- GET https://{adres serwera FHIR}/ekok/fhir/PractitionerRole?location:Location.identifier={Location.identifier}&role=organization_coordinator
Przykład żądania wyszukania danych zawierających role koordynatora podmiotu z podaniem nazwy placówki w której pracuje:
- GET https://{adres serwera FHIR}/ekok/fhir/PractitionerRole?location:Location.name={Location.name}&role=organization_coordinator
Przykład żądania wyszukania danych zawierających role koordynatora podmiotu z podaniem miejscowości w której placówka się znajduje:
- GET https://{adres serwera FHIR}/ekok/fhir/PractitionerRole?location:Location.address-city={Location.address.city}&role=organization_coordinator
Przykład żądania wyszukania danych zawierających aktywną role koordynatora podmiotu:
- GET https://{adres serwera FHIR}/ekok/fhir/PractitionerRole?&role=organization_coordinator&active:not=false
Żądanie wyszukania pozwala również w ramach jednego zapytania zwrócić dane zawierające role koordynatora (PLEKOKCustodian), dane identyfikacyjne osoby będącej koordynatorem (PLEKOKPractitioner) oraz dane placówki medycznej w kontekście której pracuje koordynator (PLEKOKLocation)
Przykład żądania wyszukania z dołączonymi zasobami :
- GET https://{adres serwera FHIR}/ekok/fhir/PractitionerRole?practitioner:Practitioner.identifier={Practitioner.identifier.system}|{Practitioner.identifier.value}&_include=PractitionerRole:practitioner&_include=PractitionerRole:location
Ze względu na ochronę danych osobowych numer PESEL osoby będącej koordynatorem nie jest zwracamy w wyniku wyszukiwania.
Wyszukanie danych identyfikujących osobę będącą koordynatorem
System umożliwia wyszukanie zasobu FHIR z danymi identyfikującymi osobę będącą koordynatorem w oparciu o zadane kryteria.
Warunki wejściowe:
- Pobrany token dostępowy
Scenariusz:
- Wyszukanie danych identyfikujących osobę będącą koordynatorem, w oparciu o zasób FHIR Practitioner, w zakresie zdefiniowanym w profilu PLEKOKPractitioner
Dostępne kryteria wyszukiwania :
- identifier (Practitioner.identifier) - identyfikator osoby,
- family (Practitioner.name.family) - nazwisko osoby,
- given (Practitioner.name.given) - imię osoby.
oraz pozostałe parametry wyszukania zgodnie ze specyfikacją FHIR dla zasobu Practitioner
Ze względu na ochronę danych osobowych numer PESEL osoby będącej koordynatorem nie jest zwracamy w wyniku wyszukiwania.
Wyszukanie danych placówki medycznej, w kontekście której pracuje koordynator
System umożliwia wyszukanie zasobu FHIR z danymi placówki medycznej, w kontekście której pracuje koordynator w oparciu o zadane kryteria.
W przypadku, gdy dane placówki medycznej nie zostały zarejestrowane w KSK lub istniejące dane w KSK są nieaktualne, zasób Location jest rejestrowany/aktualizowany w ramach operacji wyszukania danych placówki medycznej.
Warunki wejściowe:
- Pobrany token dostępowy
Scenariusz:
- Wyszukanie danych placówki medycznej, w kontekście której pracuje koordynator, w oparciu o zasób FHIR Location, w zakresie zdefiniowanym w profilu PLEKOKLocation
Dostępne kryteria wyszukiwania :
- identifier (Location.identifier) - identyfikator placówki medycznej,
